home *** CD-ROM | disk | FTP | other *** search
/ Clickx 115 / Clickx 115.iso / software / tools / windows / tails-i386-0.16.iso / live / filesystem.squashfs / usr / share / doc / xz-utils / README.Debian < prev    next >
Encoding:
Text File  |  2010-11-11  |  2.2 KB  |  65 lines
  1. XZ Utils for Debian
  2. ===================
  3.  
  4. Contents:
  5.  1. Differences from standard XZ Utils
  6.  2. History
  7.  3. LZMA Utils compatibility
  8.  4. Configuration
  9.  
  10. Differences from standard XZ Utils
  11. ----------------------------------
  12.  
  13.  * The soname of standard liblzma was bumped to 5.0.0, while Debian
  14.    liblzma remains at 2.0.0.
  15.  
  16.  * Some corners of the liblzma API (like layout of reserved fields)
  17.    have therefore been maintained at an older version in Debian
  18.    liblzma.  Pre-compiled applications built against liblzma on
  19.    other distributions are likely not to work on this version of
  20.    Debian if an additional compatibility library is not installed.
  21.  
  22. See /usr/share/doc/liblzma2/README.Debian for details.
  23.  
  24. History
  25. -------
  26.  
  27. XZ Utils should have been called LZMA Utils 4.42, but it came too late.
  28. The old .lzma file format has some problems, worst of which is the lack
  29. of magic number, but it gets enough use to still need to be supported.
  30. See /usr/share/doc/xz-utils/history.txt.gz for the full story.
  31.  
  32. LZMA Utils compatibility
  33. ------------------------
  34.  
  35. To support old scripts and muscle memory, XZ Utils can emulate the
  36. legacy LZMA Utils interface.  To use this feature, you can install some
  37. subset of the following list of symbolic links to your $PATH.
  38.  
  39.     lzma, unlzma, lzcat -> /usr/bin/xz
  40.     lzgrep, lzegrep, lzfgrep -> /usr/bin/xzgrep
  41.     lzless -> /usr/bin/xzless
  42.     lzmore -> /usr/bin/xzmore
  43.     lzdiff, lzcmp -> /usr/bin/xzdiff
  44.  
  45. To allow administrators to keep the old lzma package, the xz-utils
  46. package does not provide those links itself.  If you would like XZ Utils
  47. to provide these commands by default for all users, install the
  48. xz-lzma package.
  49.  
  50. Configuration
  51. -------------
  52.  
  53. The memory usage of xz can vary from a few hundred kilobytes to several
  54. gigabytes depending on the compression settings.  If you would like xz
  55. to automatically scale down its settings while compressing to decrease
  56. memory usage, you can declare so by adding an option like the
  57. following to your environment (e.g., in ~/.profile):
  58.  
  59.     XZ_DEFAULTS=--memlimit-compress=256MiB
  60.     export XZ_DEFAULTS
  61.  
  62. See the "Memory usage" section of the xz(1) manual page for details.
  63.  
  64.  -- Jonathan Nieder <jrnieder@gmail.com>  Mon, 25 Oct 2010 12:29:25 -0500
  65.